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Introduction 



This manual briefly describes the new features included in the SunOS™ 4.0.3 
release. 

SunOS 4.0.3 is a full SunOS 4.0 operating system, and is fuUy compatible with 
SunOS 4.0 and 4.0. 1 . Integrated into this new SunOS release is support for many 
new hardware devices and some software features. Included also are descriptions 
of bugs fixed since the release of SunOS 4.0. 

SunOS 4.0.3 supports the Sun-2, Sun-3, Sun-4, and SPARCsystem 300 work- 
stations and servers. While the Sun-3 family now includes the Sun-3x kernel 
architecture group (see Chapter 4 in this manual), differentiating the Sun-3x from 
the Sun-3 is necessary only when discussing kernel issues. 

Note that two different sets of tapes exist for SunOS 4.0.3: one supports full 
installs only and one supports upgrades only. Please make sure you are using the 
correct tape set for your installation. 

Read the first three chapters of this manual to get an overview of this document, 
a discussion of SunOS 4.0.3 installation, and a description of software changes in 
this SunOS release. The remaining chapters describe new features and bugs 
fixed. 



1.1. Documentation 
Conventions 



This manual follows these conventions: 

D System commands and messages, as well as SunOS filenames, appear in 
listing font like this. 

□ Information you type in response to the system is shown in bold 
listing font like this. 

D Information you type that differs between users and systems is shown in 
bold italics like this. These variables often are in tables in the text, where 
you select the correct entry for your system. 
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□ Document titles show in plain, nonbold, italic font. 

□ Dialogues between you and the system are enclosed in gray boxes, like this 
command to remove a file and the system request for confirmation: 



liostname% xm filename 
rm: remove filename'^ y 

> 



□ Sections of program code show in plain listing font, enclosed in clear boxes: 



int test [100]; 
main () 

{ 

register int c, d, e^ f; 

test [a] = b & test [c & 0x1] & test[d & 0x1]; 

} 



msun 

Xr microsystems 
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Installing SunOS 4.0.3 and 
Pre-Configured Kernels 

2.1. Installation or This chapter explains when to fully install SunOS 4.0.3 on your system, and 

Upgrade? when to upgrade your system to SunOS 4.0.3. Refer to the Installing the SunOS 

4.0.3 guide for system upgrade and complete system installation instructions. 
Installing the SunOS 4.0.3 also provides descriptions, instructions, and walk- 
through examples for the installation options. 

Note The SunOS distribution tapes are labeled. If the label specifies 

“Upgrade,’ ’ you must perform a system upgrade. If it does not, you 
must perform a full installation instead. See the next sections for more 
information. 

Installing SunOS 4.0.3 To migrate from SunOS 3.x to SunOS 4.0.3, or to install a new system, perform 

a/«// installation. A full installation installs an entire operating system, 
overwriting the existing system files. 

See the Installing the SunOS 4.0.3 guide for fiiU installation instructions. 



Upgrading to SunOS 4.0.3 



2.2. The sunupgrade 

Utility 



To migrate from SunOS 4.0 or 4.0.1 to this release, 4.0.3, perform a system 
upgrade using the upgrade utility, sunupgrade. 

When you perform a system upgrade, you selectively replace those files that are 
different between the release you are running and the new release to which you 
are migrating. 

See the upgrade chapter in Installing the SunOS 4.0.3 for upgrade instructions 
and walkthrough examples. 

This section describes the new sunupgrade utility. 

The SunOS utility /usr/etc/ sunupgrade exists in the miniroot on the 
SunOS 4.0.3 release tape set. Once the miniroot files are copied over to disk, you 
can run sunupgrade to perform a system upgrade. The sunupgrade utility 
provides the necessary files to upgrade your system from SunOS 4.0 or 4.0.1. 

The upgrade process is straightforward, with an interface that requires a 
minimum of user input. User-customizable files are preserved. 




microsystems 
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Who Upgrades? 



2.3. Pre-Configured 
Kernels 



Need for Configuration 



The GENERIC Kernel 



Choices 



During the upgrade, s unupgrade prompts you for the following information: 

□ Disk device of the root partition 

□ Type of configuration: file-server, standalone, dataless client 

□ Local or remote installation 

□ Tape type 

a Any changed directory names, if you are upgrading a server 

□ Other information, particularly if performing a remote installation 

In addition, sunupgrade runs in “no rewind” mode for 1/4" tape, greatly 
speeding system upgrades. Changes to the SCSI tape drivers in SunOS 4.0.3 
make this mode of operation possible. Running sunupgrade from the SunOS 
4.0.3 miniroot allows “no rewind” operation, but remote tape installation from a 
tapehost running a release prior to SunOS 4.0.3 sunupgrade disables “no 
rewind.” You can explicidy disable “no rewind” mode by invoking 
sunupgrade with the “-n” flag. 

As a safety feature when installing dataless clients, sunupgrade does not 
upgrade a dataless client to SunOS 4.0.3 if the server does not also run 4.0.3. 

The SunOS 4.0.3 Release Manual contains the sunupgrade ( 8 ) manual page. 



SunOS 4.0.3 supports aU combinations of Sun-2, Sun-3, and Sun-4 clients (both 
standalone and dataless), and servers. 

In addition to the large default GENERIC kernel supplied with the SunOS 4.0.3, 
four pre-configured kernels for small systems are also provided. Kernel 
configuration options are briefly covered below, and are fiilly discussed in the 
Installing the SunOS 4.0.3 guide. 



Configuring your kernel or using one of the supplied configurations can 
significantly improve system performance. 



After either an upgrade to SunOS 4.0.3 or a fiiU SunOS installation, you have a 
large default GENERIC kernel. The GENERIC kernel contains all device 
drivers and options, including many that you might not need. 



You have four choices of kernels to ran after installation: 
o The large default GENERIC kernel (not reconunended) 

□ Four preconfigured small system kernels that you do not need to build 

□ Sun-supplied kernel configuration files that simplify building a custom 
kernel 

o A custom kernel that you build 



»sun 

Xr microsystems 
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configured small system kernels are listed below. 

Sun-2: 2/50 Diskless or with up to two SCSI disks and one SCSI tape 

Sun-3 (68020-based systems): 3/50 and 3/60 diskless or with up to two SCSI 
disks and one SCSI tape 

Sun-3x (68030-based systems): 3/80 diskless or with up to two SCSI disks, 
one SCSI tape, and one floppy drive 

Sun-4: 4/1 10 or SPARCsystem 330 with up to four SCSI disks and one 
SCSI tape 

Supplied Configuration Files Many convenient kernel configuration files are supplied in 

/usr/sys/sunAI?CW/conf . ARCH is 2, 3, 3x or 4 for Sun-2, Sun-3 
(68020-based), Sun-3x (68030-based), and Sim-4 systems, respectively. These 
configurations are for common systems, and allow you to rebuild a custom kernel 
more easily. 

In /usx/ sys/sunARCH/conf, file names beginning with DL are for disk- 
less systems. Names beginning with SDST are for SCSI disk and tape, and XD 
and XY files support Xylogics disk controllers. 



Supplied Small System Pre- 

Kernels 

□ 

□ 

□ 

□ 
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Software Changes in SunOS 4.0.3 



This chapter describes software changes in SunOS 4.0.3. 



3.1. New Feature — mt The mt ( l ) command supports these new options. For complete information. 

Command Options see the updated manual page shipped with SunOS 4.0.3. 

bsfm Back space count file mailcs. The tape is positioned on the beginning- 
of-tape side of the file mark. 

asf Absolute space to count file number. 1/4" cartridge drives skip directly 
from the current tape position to the requested file number. On 1/2" 
drives, the command is equivalent to a rewind followed by an f sf 
count. 

com Space to the end of recorded media on the tape (SCSI only). This is 
useful for appending files onto previously written tapes. 



3.2. Enhanced Diagnostic 
Software 



SunOS 4.0.3 includes a new diagnostic system, sundiag. This is a Sun View- 
based user interface that tests system devices and peripherals. 



The sundiag Program The sundiag program is an online system exerciser for testing peripheral 

devices. Incorporating a SunView-based interface, sundiag can be used on 
any Sun-2, Sun-3, or Sun-4 hardware configuration nmning SunOS 4.0 and later. 
Configure the system kernel to support all peripheral devices to be tested. 

sundiag executes system tests that formerly were performed by sysdiag, 
and runs aU sundiag tests written for new Sun products. Read the Sundiag 
User’s Guide, Part Number 800-3804, for complete information about using 
this test program. The sundiag program is in the / usr / diag/ sundiag 
directory. 
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3.3. Programs Moved to 

/usr/ old 

sysdiag 

perfmon 
setkeys 

NOTE: /usr /old/ setkeys does not woik with the Type-4 keyboard shipped with 

the new Sun hardware. 



The sysdiag utility is being replaced with the new sundiag utility, a 
window-based diagnostic exerciser. For SunOS 4.0.3, sysdiag is moved to 
/usr/old. 

The perfmon utility was moved to /usr/old/ perfmon in SunOS 4.0. 

The setkeys program is being phased out of SunOS and replaced by the input 
function in the default sedit program. The setkeys utility was moved 
to /usr /old/ setkeys in SimOS 4.0. 



3.4. New Software for New The following software features have been added to, or changed in, SunOS 4.0.3. 
Hardware 

New arch Options The arch command includes the new option, -k. Executing arch -k 

prints the kernel architecture type, such as sun 3 (for 68020-based systems) or 
sun3x (for 68030-based systems). This indicates the UNIX® kernel that runs 
on the machine, and is important only for programs explicitly depending on the 
kernel architecmre. 

The arcA/uwfie option is also new to the arch command. The command 
arch archname returns true when the machine can run the application 
binaries of the archname machine architecture, and returns false when it 
cannot run those binaries. 

For example, arch sun3 returns true on both Sun-3 and Sun-3x kernel 
architectures because these machines are binary compatible for application 
software. 

See Section 4.3, Differences Betweeen Sun-3 (68020-based) and Sun-3x (68030- 
based) Workstations for an explanation of the term “kernel architecture.” See the 
new ar ch { 1 ) manual page in the Change Pages and Addenda to the Docubox 
document set for details of the new arch command options. 



Enhancements to make The make ( 1 ) command is enhanced in the way it assigns the output of shell 

commands to variables. With these changes, the make command takes advan- 
tage of new ar ch { 1 ) features. 

See the new make ( 1 ) manual page in the Change Pages and Addenda to the 
Docubox document set for new information. 
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Entries in /et c/ f stab and Because of changes to the directory structure of SunOS 4.0.3, system administra- 

/etc/exports tors must now mount /usr /kvm explicitly as an additional entry in the client’s 

/etc/f stab file, and must explicitly export 

/export /exec/ kvm/ cUent kernel arch in the server’s etc/exports. 

Note to System Administrators System Administrators: See the System Administration Addenda in the Change 

Pages and Addenda to the Docubox for full explanations of SunOS 4.0.3 system 
administration issues. 

/usr: New and Changed Read about changes to the /usr directory stmcture in the Change Pages and 

Directories Addenda to the Docubox document set, in the System Administration Addenda. 

New eject Utility The new eject utility supports software ejects for floppy disks on the 

Sun- 3/80. Read the e ject ( 1 ) manual page in the Change Pages and 
Addenda to the Docubox document set for a full description of eject features. 

New f df ormat Utility The new f df ormat utility supports floppy disk formatting on the Sun-3/80. 

Read the fdf ormat ( 1 ) manual page in the Change Pages and Addenda to 
the Docubox document set for a full description of fdf ormat features. 

Change to mon/eeprom . h mon/eeprom . h is changed to support the Sun-3/80. 

New Devices MAKE DEV now creates the fd, pp, and ppdiag devices. 

□ f d is the Sun-3/80 floppy drive. 

□ pp is the Sun-3/80 printer port. 

□ ppdiag is a diagnostics special device file. 

The GENERIC The standard GENERIC configuration file has been changed to support new 

Configuration File devices. 
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4.1. The Sun-3/80 Desktop 
Workstation 



Floppy for the Sun-3/80 



4.2. Sun-3/470 Deskside 
Workstation and 
Sun-3/480 Server 




The Sun-3/80 and Sun-3/470, Sun-3/480 

Workstations and Servers 

The Sun-3/80 is a low-cost desktop system featuring optional integrated mass 
storage and an optional floppy disk. Based on a 20 MHz Motorola 68030 proces- 
sor with a base configuration of 4 megabytes of dynamic random access memory 
(DRAM), the Sun-3/80 is binary-compatible with most applications based on 
other Sun-3 products. This compact system has a wide variety of configurations. 

The Sun-3/80 has many attractive features for users preferring the familiar 680j^) 
architecture: 

□ Compact packaging 

□ Motorola 68882 floating point imit (standard) 
a Optional integrated floppy disk 

□ Optional integrated ?>-\p." SCSI hard disks 

□ Many frame buffer and graphics accelerator options 

□ External mass storage expansion capability 



SunOS 4.0.3 supports the 3-1/2" flexible diskette (floppy disk) drive used in the 
Sun-3/80 Woikstation. This floppy is an industry standard, non-SCSI device 
with a 1.44 megabyte capacity. 

You use the floppy in the same ways as you use other disks. For example, the 
floppy disk can contain a UNIX file system and can be mounted like any ottier 
disk partition. In addition, floppy disks can be used to boot the system and to 
copy application software from diskette to your system. SunOS knows the 
floppy as /dev/fdO. 



The Sun-3/470 and Sun-3/480 are based on the 33 MHz Motorola 68030 proces- 
sor. Both systems provide many important features and offer a variety of expan- 
sion options: 

□ 33 MHz Motorola 68882 floating point unit (standard) 

□ Optional high-performance floating point accelerators 

□ Many frame buffer and graphics accelerator options 
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□ 60- and 150-megabyte 1/4" tape drives 

□ 1/2" 6250/1600 bpi tape drive 

□ Up to 1 .3 gigabytes of SCSI disk storage 

□ Any combination of 4 SMD-4 controllers and 8 SMD disk drives on the 
Sun-3/470 

□ Any combination of 4 SMD-4 controllers and 16 SMD disk drives on the 
Sun-3/480 

Cartridges for the 150- The 150-megabyte tape drive can write to the 3M-DC6150 tape cartridge 

megabyte 1/4" tape drive (formerly the 3M-DC600XTD tape cartridge), available as Sun part number 

370-1203-01. 

Tapes written on the 60-megabyte tape drive, such as the 3M-DC300XL/P tape 
cartridge (Sun part number 370-0543) and DEI Series II Silver (Sun part number 
370-0543) tape cartridge, can be read on the 150-megabyte tape drive. Failure 
to use the proper tape for the specified tape drives, or use of any other tape 
cartridges, is not supported by Sun Microsystems. 

To find the type of tape drive installed on your system, load a tape into the drive 
and enter the following command, replacing NUM with the number of your tape 
device (for example, /dev/r st 8): 

mt -f /dev/rstAt/M status 

The following message displays when you have a 150-megabyte 1/4" tape drive: 

Archive QIC-150 tape drive: 

sense key (0x0)= no sense residual= 0 retries= 0 
file no= 0 block no= 0 



4.3. Differences Between 
Sun-3 (68020-based) 
and Sun-3x (68030- 
based) Workstations 



The new 68030-based, Sun-3x, computers (Sun-3/80, Sun- 3/470, and Sun-3/480) 
are members of the Sun-3 family and run Sun-3 user-level applications 
unchanged. However, while the Sun-3 uses the MC68020 and the Sun MMU, 
the Sim-3x uses the MC68030 with an on-chip MMU. This difference necessi- 
tates a unique kernel for each of the two system architectures. 

For detailed information about the MC68020, see the MC68020 User’ s Manual, 
MC68020UMIAD Rev 1 and the Sun-3 Architecture Manual. To understand the 
MC68030, read the MC68030 User’s Manual, MC68030UMIAD Rev 1. 

Because the 68020 and 68030 run the same application binaries, they are said to 
have a sun3 application architecture. Because they require different kernel- 
dependent code, however, their kernel architecture is different: the 68020 has a 
sun3 kernel architecture, while the 68030 has a swnJx kernel architecture. 

The application architecture is displayed by arch, while the kernel architecture 
is displayed by arch -k. See the arch { 1 ) manual page for details. 
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User programs 



Drivers 



Other Differences 



Following is a list of differences between the Sun-3 and Sun-3x architectures that 
can require you to relink, recompile, or rewrite a program. 



□ Relink, or recompile and relink, programs that read or write kernel data 
stmctures. Relink programs that use the libkvm library. Recompile pro- 
grams that depend on kernel data stmcture offsets or sizes. 

□ Programs using the 68020 callmand rtm instructions do not work on 
the 68030 because these instructions do not exist on the 68030. This should 
not cause problems, as the compilers never generate these instmctions. 

□ Re-port programs that assume that the user stack starts at a particular loca- 
tion. On a Sim-3x, the user stack starts at OxeOOOOOOO. On a Sun-3, the user 
stack starts at OxOfOOOOOO. In particular, programs assuming the stack 
pointer is “positive” will not woik. 

□ Recompile drivers accessing kernel data stmctures (such as the user area and 
the process table). The offsets of a field in these stmctures can be different 
between the Sun-3 and the Sun-3x. 

□ Rewrite drivers that “know” about page table format, such as some graphics 
drivers, to use the 68030 page table format. 

□ Rewrite drivers with hard-coded kernel addresses to use the correct 
addresses on the Sun-3x architecture. 

□ Change drivers that access the system enable register, such as some graphics 
drivers. This is a short on the Sun-3x architecmre rather than a char. 

The following two items apply to the Sun-3/470 and Sun-3/480 only: 

□ Insert delays for some drivers (for example, the DES driver) to wait for 
hardware to be ready. The Sun-3/470 and Sun-3/480 machines need these 
delays because they are faster than other Sun-3 machines. 

□ For improved performance, rewrite disk and Ethernet drivers (and possibly 
others) to take advantage of the I/O cache. To do this, marie the buffer with 
the B_I0CACHE flag in the strategy routine if the buffer is aligned properly 
(16 bytes), and turn this flag off in the intermpt routine when the I/O 
completes. 



The kernel, kadb, the boot blocks, the t f t pboot program for Sim-3x 
clients, and libkvm are different between the 68020 and the 68030. Also, the 
arch -k command prints sun3x on a Sun-3x machine and sun3onaSun-3 
machine. 
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Compiling Kernel-Dependent The following techniques are recommended when the same kernel-dependent 
Code source code is to be compiled for both the sun3 and sun3x targets. 

o Use the enhancements to arch ( 1 ) and make ( 1 ) in your makefile to 
define either “sun3” or “sun3x.” These ar ch { 1 ) and make { 1 ) enhance- 
ments are new with SunOS 4.0.3, and the following example does not woik 
with the arch ( 1 ) and make ( 1 ) commands from previous releases. 



ARCHish = arch -k 
CPPOPTS= -D$(ARCH) 
CFLAGS= $(CPPOPTS) 



□ As appropriate, use # if def sun3 and #if def sunSx inyourcode. 

s 

#if def ined (sun3) II def ined(sun3x) 
code identical for the Sun-3 and the Sun-3x 
#endif sun3 I I sun3x 

#ifdef sun3 

code for the Sun-3 only 
#endif 

#ifdef sun3x 

code for the Sun-3x only 
#endif 

> 



Note that you must explicitly ask for the definition of C pre-processor %architec- 
ture S 5 Tnbols like sun3 and sun3x, invoking the compiler with 
cc -DsunSorcc -Dsun3x. These symbols are not defined by default. 

Also, while -sun3 is a legal cc command-line option for both the 68020-based 
Sun-3 and the 68030-based Sun-3, -sun3x is not a legal cc command-line 
option. 
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SPARCsystem 300 Deskside 
Workstations and Servers 

5.1. SPARCsystem 300 The SPARCsystem 300 is a family of high-performance computer systems based 

Overview on the 25 MHz Reduced Instruction Set Computer (RISC) processor, SPARC 

(Scalar Processor ARChitecture). The SPARCsystem 300 packaging options and 
expansion capabilities meet a diverse set of computing needs. 

5.2. SPARCsystem 330 The SPARCsystem 330 compact deskside package offers integrated mass 

storage and backup capabilities. Features of the SPARCsystem 330 include the 
following. 

□ High-performance floating point unit (standard) 

□ Many frame buffer and graphics accelerator options 

□ Three 9U x 400mm VME slots 
a Two 6U X 160mm VME slots 
o 150-megabyte 1/4" tape drive 

□ Up to 1 .3 gigabytes of SCSI disk storage 

The 150-megabyte tape drive can write to the 3M-DC6150 tape cartridge 
(formerly the 3M-DC600XTD tape cartridge), available as Sun part number 
370-1203-01. 

Tapes written on the 60-megabyte tape drive, such as the 3M-DC300XL/P tape 
cartridge (Sun part number 370-0543) and DEI Series II Silver (Sun part number 
370-0543) tape cartridge, can be read on the 150-megabyte tape drive. Failure 
to use the proper tape for the specified tape drives, or use of any other tape 
cartridges, is not supported by Sun Microsystems. 

To find the type of tape drive installed on your system, load a tape into the drive 
and enter the following command, replacing NUM with the number of your tape 
device (for example, / dev/r st 8): 

mt -f /dev/rstVf/M status 



Cartridges for the 150- 
megabyte 1/4" tape drive 
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The following message displays when you have a 150-megabyte 1/4" tape drive: 
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GPSI Enhancements 



6.1. GPSI Features This newest release of GPSI (Graphics Processor Software Interface) microcode 

adds the following new features to the Sun graphics processor family — the 
GP2/CG9, GP2/CG5, and GP+/GB/CG3 graphics board sets. 

1. Picking 

2. Matrix Stack 

3. Markers 

4. Z-Buffeied Vectors 

5. Depth-Cued Vectors 

6. RGB (Red-Green-Blue) Color Model Support, including Gouraud-shaded, 
RGB-inteipolated polygons, and shading of vectors. 

7. Lighting 

8. Stroke Text 

The first five items ate new GP 1_ GPSI commands for the GP2 and GP+ graph- 
ics accelerator boards. They are inoperative on the older GP because of micro- 
code space limitations, but will nevertheless run GPSI applications using the new 
commands on the GP without problems. 

Items 6 and 7 extend the GPSI interface to support true color: color is specified 
and processed as RGB (red-green-blue) triplets. The new RGB vector and 
polygon support makes the GP2 a “tme color” graphics engine and provides the 
foundation for advanced shading and lighting. For compatibility, the “index 
color” GPSI commands are stUl available. Items 6, 7, and 8 are provided only 
for the GP2 (not for the GP or the GP+); to make this clear, these GPSI com- 
mands begin with GP2_ instead of with GP 1_. 

Lighting support is now provided by the GP2 as follows: 

□ Colored ambient light 

□ Eight independent colored light sources 

□ Diffuse light reflection model 

□ Infinitely distant directional light sources 
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D Back facing polygon rejection 
o Back face lighting 
□ Specular reflection 

In addition, the GP2 now supports the downloading of stroke fonts to provide 
fast stroke text drawing speeds. 

These new GPSI microcode enhancements are supported on the new 24-bit, 
GP2/CG9 graphics accelerator board set, as well as the existing GP2/CG5 board 
set and, with exceptions as noted, the GP+/GB/CG3. 



6.2. Software Integration The GPSI microcode is integrated into SunOS 4.0.3, and is found in the 

/ u s r / 1 ib directory. 



Colorcube To use the new RGB GPSI commands with the CG5 8-bit color board, load the 

CG5 color map with a 5-9-5 color cube (5 levels of red, 9 levels of green, and 5 
levels of blue). 

This 5-9-5 color map is in the header file 

/usr/ include/ sunwindow/ cms colorcube .h. 



Programmer’s Guide An addendum to the GPSI programmer’s guide, GPSI Programmer’ s Guide 

Addendum (800-3616-01), is available. 
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CG6 Graphics Accelerator Board 



The CG6 board accelerates the performance of many 2D and 3D graphics appli- 
cations. This P4 color frame buffer uses two ASICs to accelerate production of 
eight-bit color images. The GX graphics accelerator is the S4 version of the 



CG6. 



7.1. Supported The CG6 graphics accelerator plugs into the P4 bus on these Sun woikstations: 

Workstations 3/60, 3/80, 3/470, 3/480, 4/1 10, and SPARCsystem 330. To install the board, 

foUow the instmctions in the hardware installation manual that accompanies the 
board. 

7.2. Software Interface to The software that supports CG6 functionality is included in SunOS 4.0.3. 

CG6 

Supported Graphics The following four types of graphics libraries are available for Sim woikstations 

Application Software equipped with CG6 boards. 

□ PixWin 

□ Pixrect 

□ SunGKS 

□ SunPHlGS 

Compatibility When upgrading applications to the CG6, the following compatibility considera- 

tions apply. 

□ Applications prepared with CGVCORE are not supported on the CG6. 

□ Statically linked applications ran, but are not accelerated, on the CG6. 

□ Dynamically linked (or manually relinked) applications are accelerated by 
the CG6. 

□ Recoding is necessary in the following cases: 

□ Where overlays are required or expected by the application. 

□ Where the application depends on the existence of PixWin or Hxrect 
internal data structures. 
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Documentation 



o Where the application is written in CGI or CORE. 

For more information on performance tuning applications for the CG6, refer to 
the GX Technical Note. 



The following manuals are general references on CG6-related topics. 

a The SunView Programmer’ s Guide, Part Number 800- 1783-10, and the 
SunView System Programmer’s Guide, Part Number 800-1784-10 

o The Pixrect Reference Manual, Part Number 800-1785-10 

□ The SunPHIGS Reference Manual, Part Number 800-2475-0 1 , 
and the SunPHIGS Programming Guide, Part Number 800-2476-01 

□ The GX Technical Notes 

□ The SunGKS Rrference Manual, Part Number 800-3560-01 

o The SunGKS Software Installation Guide, Part Niunber 800-3561-01 

o Read This First for the SunGKS Installation Guide, 

Part Number 800-3652-01 
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8.1, Keyboard Features 



Type-4 Advantages 



Changes for the Type-4 



Unsupported Features 



Type-4 Keyboard 



Type-4 keyboards are the new standard for Sun workstations. SunOS releases 
4.0 dirough 4.0.3 allow you to use the Type-4 keyboard as the earlier Type-3 
keyboard was used. AU earlier Sun keyboards are supported, also. 



Current advantages of the Type-4 keyboard over the T5rpe-3 keyboard are: 

n The Type-4 keyboard has three more software-programmable function keys 
than the Typ>e-3 keyboard. 

□ The Type-4 keyboard passes standards for electronic emissions in several 
countries. 



The I Left 1 and I Right 1 keys on the bottom row of the older Type-3 keyboard now 
show diamond symbols instead of the words Left and Right. Key function for 
these “meta” keys is unchanged. 



Many features of the T)^-4 keyboard will be supported in coming SunOS 
releases. New keys on the the Type-4 keyboard that are not yet supported rmder 
Sun View are: 

o [ Hein I on the left keypad 

□ t Compose I . [ Alt ) . and I Alt Graph I on the bottom keyboard row. 

□ AU keys on the right (numeric) keypad. 

Future releases wiU also support the “Key Lights” (also caUed LED) panel 
above the right ke)^ad. 

FinaUy, the setkeys utility (/usr /old/setkeys) does not work with the 
Type-4 keyboard and is being phased out. Use the iiy}ut function in the 
def aultsedit program in place of setkeys. 
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24-Bit-Color Support 



9.1. 24-Bit Color Frame The new 24-bit frame buffer, the CG8, uses 24-bit-deep pixels to produce true- 

Buffer Board, CG8 color images. The CG8 color lookup table allows for color adjustments, such as 

gamma correction, on the standard 900x1 152 resolution display. 

The monochrome overlay plane and enable plane allow displaying either the 
color or the monochrome plane on a pixel-by-pixel basis. 

SunOS 4.0.3 provides a software driver, and code for enhancements to Pixrects 
and SunView 1 that take advantage of 24-bit color. The code changes are docu- 
mented in the Pixrect Reference Manual and in the SunView 1 Programmer’ s 
Guide. See also the document set Change Pages and Addenda for the Docubox 
for release notes on 24-bit-color support. 

Note: Eight-bit indexed color applications must be modified to run with the 24- 
bit color frame buffer. Unmodified applications will run, but will display images 
incorrectly — most likely, with an all-red screen. 
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SunDials 



10.1. SunDials SunDials is an image-manipulation input device for Sun-3, Sun-4, and 386i 

workstations, using an RS-232 serial interface. The desk-top dialbox is compact, 
measuring 8.63"x5"xl.l5". 

The dials can be programmed to change colors and manipulate images. Image 
manipulation such as scaling, translating, rotating, and zooming is essential for 
many CAD applications. 

Sun View directs SunDials input to the process owning the window (where the 
cursor is located). SunDials extends the interactivity of the display controller 
beyond the current capabilities of a mouse or digitizing tablet. 

The SunDials device driver is integrated into the GENERIC kernel. No optional 
software or kernel reconfiguration is required, but kernel reconfiguration is 
recommended for optimal performance. 
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Floating-Point Unit, FPU2 




FPU2 Floating-Point Unit 



The FPU2 is a new floating-point hardware unit for the Sun-4/1 10, 150, 260, and 
280. The FPU2 has a TI 8847 floating-point unit with an LSI Logic controller 
chip. 

SunOS 4.0/Fortran 1.1 programs can run unaltered after you install the FPU2. 
The inline expansion template file /usr/lib/sqrt . il, included on this 
tape, may optionally be used to improve performance of Sun-4 FPU2 on prob- 
lems that perform many square root operations. The inline expansion templates 
replace calls to sqrt subroutines with hardware instructions. Executables 
created with these templates may run slowly on older Sun-4s with the Weitek 
1164/5 floating-point hardware, which has no sqrt instructions. 



Use the inline expansion template by recompiling with either of these 
commands: 



— 
til -04 source. f /usr/lib/sqrt . il 


/usr/lib/libm. il 




or 






cc -04 source. c /usr/lib/sqrt . il 
< 


/usr/lib/libm. il -Im 





For more information on inline expansion templates, see the inline ( 1 ) 
manual page and the Floating-Point Programmer’ s Guide accompanying 
SunOS 4.0. 

A new utility program searches for the FPU2. This utility, f puversion4 ( 8 ) , 
determines whether the high-performance floating point components are installed 
on the system CPU. Detecting the presence of the FPU2, the diagnostic prints a 
confirming message: 

Sun-4 floating-point controller version 2 found. 

^ > 
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FPA+ 



12.1. Description The FPA+ is a high-performance floating point accelerator for use in the 

Sun-3/470 and Sun-3/480 systems. 

While it is object-code compatible with applications written for the Sun-3 FPA, 
this new unit performs floating point operations faster than the FPA because it 
runs at the CPU speed of 33 MHz and uses fewer cycles for each operation. 
While the FPA occupies an entire 9U slot, the FPA-t is a daughter board that 
attaches directly to the CPU board, and therefore occupies no additional slots. 

Both FPA-i- and FPA microcode are supplied with this release. The 
f pa_download ( 8 ) command is changed to pick up the appropriate 
version. 
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High-Performance SMD Disk Drive 

and Controller 



This is a high-capacity, 8" disk drive based on Winchester technology. Called 
the Storage Pedestal Upgrade Drive (SPUD), the drive has an unformatted capa- 
city of 700 megabytes and formats to 688 megabytes. This is 2.5 times greater 
than the existing 8" disk drive in the Sun Mass Storage Pedestal, although it 
occupies the same physical space. 

The SPUD also improves on the access time, cost per megabyte of storage, and 
reliability of the current 8" drive. Performance improvement results in part from 
SMD-4, the new SMD controller. 

13.2. VME/SMD Disk This high-performance VME/SMD disk controller has a 128-kilobyte read-ahead 

Controller cache and a pipelined bus DMA architecture. Each controller supports up to four 

of one type of the following disk drives: 

o 8" 688-megabyte disk drive 

a 10" 575-megabyte disk drive 

□ 9" 892-megabyte disk drive 

The disk controller also supports the following functions: 
a Overlapped seeks 

□ Read and write optimizations 



13.1. 688-Megabyte SMD 
Disk Drive 
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Bug Fixes From SunOS 4.0.1 
Through SunOS 4.0.3 

14.1. Introduction This chapter describes the bugs fixed since the release of SunOS 4.0. 

The bug-fix descriptions are categorized as follows: 

Graphics 

SunOS 

Kernel 

SCSI drivers 

Serial drivers 

Network 

Compiler 

Debugger 

Utilities 

System Administration 
SunView 



14.2. Graphics Bugs Fixed The following graphics bugs have been fixed. 



System Hung When GP2 GP2 could hang the system when trying to render some polygons. 

Rendered Polygons 



Extra Pixels Affected Texturing The GP2 (PHIGS microcode) drew texture lines that appeared to be incorrect. 

There were additional pixels at each break in the texturing. 



Incorrect Vector Identified for When lines (usually diagonal) were transformed through GP2 using 
Picking _PROC_LINE_FLT_3D, bit 15 of clip_f lag was not set if the vector was 

totally invisible. This caused an incorrect vector to be identified for picking in 
SunPHIGS. 



microsystems 



61 



Revision A of 24 April 1989, Part. No. 800-3815-10 



62 SunOS 4.0.3 Release Manual 



Overlay Colormap The colormap of a one-bit-deep frame buffer can now be changed. 



_XF_LINE_FLT Left _XF_LINE_FLT could leave an extra pixel outside the clipping viewport. 

Extra Pixel 

clip_f lag Error on When running GP2 on a Sun-3/260, there could be an error in clip_f lag 

Sun- 3/260 when you used the command GP1_PR0C_LINE_FLT_3D. 



Polygons with Many If you used GP1_xf_PGON_INT_2D to draw a polygon with 370 or more 

Nonhorizontal Edges nonhorizontal edges, the GP2 could hang the system. 



SunPHIGS Programs Died SunPHIGS programs died (typically, receiving S IGXCPU signal while drawing 

SOLID-fiUed fill areas) on a Sun-4/150. 



GP-h Drew Textured Polygons The GP-f rendered textured polygons even though the pick mode flag was set to 

with PICK_NODRAW Set PICK_NODRAW(2). This has been fixed so that, in pick mode, primitives are 

analyzed for picking, but not drawn. 



Auto Arrays in Several functions in pr_texvec . c declared auto arrays named segarray, 

pr_texvec . c with which could be used after the declaring functions returned. The problem was 

Same Name noticed when a program using pr_line looped indefinitely in bres_vert 

after compiling the (SPARC) Pixrect library -02. (The stack layout was 
sufficiently rearranged to manifest the problem.) 



Invisible Cursor with CG4 When suntools displayed an alert box, the cursor was invisible on any 

Frame Buffer machine with a CG4 frame buffer. 



cf ramedemo Dumped Core The cf ramedemo program compiled, but dumped core when it raa 



Incorrectly Drawn Cursor in Because of an initially faulty CG8 pixrect implementation, the cursor was 

suntools Reverse Video not drawn in reverse video. The cg8_colormap . c file has been changed to 

fix this bug. 



Missing CG8 Driver Functions The cgeight driver functions were missing from the stubs . c file, causing 

undefined symbols messages in some configurations. Adding cgeight 
driver functions to the stubs . c file fixed this bug. 
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Cursor Was Drawn Wrong in sunview uses the side-effect of the pixrect library function 

Reverse Video with CG8 pr_putcolormap to decide if the screen is in reverse video. It expects the 

kernel to have the same function with the same side-effect to draw the cursor 
correctly. CG8 pixrect implementation initially did not do this. This is fixed. 



pr_polyline Destroyed GP2 The pixrect code has been changed to reset the line type after polymarker 
Context Line Texture primitives. 



14.3. SunOS Bugs Fixed This section describes bug fixes in the SunOS. Those applicable to the operating 

system are listed first 



/usr/ucb/w 



The w program did not display processes on the console. 



f ilemerge The f ilemerge program was inadvertently left out of SunOS 4.0 (it should 

have been moved to /usr /old). The program is now in place, and the 4.0 
SunOS Reference Manual contains a manual page, oldf ilemerge ( 1) . 



fpa_download fpa_download, which runs from rc . local at boot time, now outputs data 

to indicate that it is downloading the FPA or FPA+ programs. The rc. local 
file is changed with this fix, and the fix file is stored where all clients of a server 
have access to it. Read and follow the installation instructions carefully to 
prevent overwriting customized rc . local files. 



Idcore When compiling a set of . o files imder SunOS 4.0 and using two Ids to link 

the programs, the second Id dumped core. The problem was associated with 
overflowing the hard limit for the number of symbols in one . o file. This bug 
is fixed. 



libc Execution of set logmask ( 3 ) resulted in a core dump and segmentation 

fault; calling syslog (3) before openlog (3) dumped core; yellow-pages 
support for the resolver (nameserver) did not work; and f put failed when there 
was more than one newline on line-buffered streams. 

This bug was introduced when many library routines were changed. A number 
of libc (and other) files are now changed, and special rebuild and installation 
instmetions are given in the README file of the 4.0.1 bugfix tape. These bugs 
are fixed. 
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liblwp, -llwp Programs did not link with the lightweight process hbrary; Sun-2 and Sun-3 link 

attempts caused an error message, regoffset undefined; Sun-4 attempts 
produced SP_0FFSET, PC_0FFSET, and others. This bug is fixed. 



Misleading syslog ( 3 ) According to the manual page, “If special processing is needed, openlog { ) 

Manual Page can be called to initialize the log file.” In fact, openlog (3) wiAsr be called 

before syslog ( 3 ) is used or logging will not occur. 



Daylight Savings Time Daylight savings time was handled incorrectly for the U.K., Australia, and parts 

Incorrectly Handled of Europe. This has been fixed to match the latest EEC agreement. 



386i Security Hole 

14.4. Kernel Bugs Fixed 



The -h feature of ypset could breach yp domain security to allow root access. 
This section describes bug fixes in the SunOS kernel code. 



Diskless Qient Boot Panic While booting a diskless machine under 4.0, a sleep occurred that caused the 

system to panic. 



Driver Mapping Requests The kernel routines in SuniV/machdep . c use a locally defined constant 

MAXMPHYS to limit the maximum DVMA window for raw device I/O. If a 
driver requested a larger mapping, the kernel would panic. 



Pseudo-ttys Could Hang csh Depending on the setting of shell environment variables, a pseudo-tty could 
or shellt ool cause a shell (csh) or shelltool to exit or hang. Rebooting the system 

returned the pty to its normal state. This has been fixed. 



Diskless Qients Froze When When booting multiple diskless chents simultaneously from a 3/280 server, some 
Booted Simultaneously clients froze. This is no longer the case. 



Bus Error Running a program that used TIOCOUTQ ioctl caused a “panic: bus error” 

under SunOS 4.0. The tty . c program has been changed so this no longer 
happens. 



KERNELBASE and SYSBASE 
Definitions 



KERNELBASE and SYSBASE definitions, along with a problem in 
bus check { ) , precluded mapping in buffers that were allocated in kernel 
data/bss. 
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Missing Initialization in 
Socket Code 



The send-related kernel socket code was missing an initialization. This has been 
fixed. 



Vnode for Console Missing 



Performing the TIOCCONS ioct 1 on the controller device of a pty could panic 
the kernel. 



exec Failures May Not Clean 
Up Properly 



In some cases, exec failures did not clean up properly. In particular, the path- 
name buffer allocated for the initial lookup was not freed, and the vnode for the 
file was not released. 



Interrupt Priorities on Sun-4s 
Tapemaster Driver 
Calls Improperly Nested 

St Driver 



On Sim-4s, the system could hang due to problems with interrupt priorities. 

The Tapemaster driver caused a system panic when tar or diomp was used. 

The exit routines at the end of the mntime code used by boot to save the caller’s 
stack environment did not nest calls. 



The St driver did not behave as documented in st ( 4 ) . When read ( ) sees a 
tape mark, it does not proceed to the next tape file. 



Drivers Test Returns from Because kmem_alloc no longer panics if it can’t return memory, drivers now 

kmem alloc must test returns from kmem alloc. 



sysdiag Test Hangs: 



The tapetop 1/4" tape test in sysdiag hung at start-up. 



uucico 



A system panic sometimes occurred due to a data fault at location stropen+dc 
when running the user program uucico. 



NIT STREAMS Buffering The NIT STREAMS buffering module, nit_bug ( 4m) , failed to collect mes- 

Module sages into chunks that arrived on its read queue. Instead, each message was 

passed to its upstream neighbor upon receipt. 



Multiple Contiguous Writes Multiple contiguous writes to two SCSI disks on the same controller could hang 

Hung Bus the bus. 
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Null mblok Dereferenced 
Reselect Interrupt Recovery 

VPC-2200 Device Driver 
Read and Write System Calls 



The wscon driver could dereference a null mblk. 



For certain configurations, a message did not indicate that a hardware problem 
involving a lost reselect interrupt had been recovered in software. 



The device driver for the VPC-2200 did not work correctly. 



Read and write system calls did not always woric on a Sun-4 when the buffer was 
in the VME space (usually obtained via an itimap ( ) call). 



System Crashed when Exiting The system could crash when exiting MaUtool. 
Mailtool 



mknod on Customized Kernel Executing mknod on a customized kernel could cause a panic : bus 
Caused Panic error : if size routines in the xy and sd drivers deferenced pointers to 

structures for which memory had not been allocated at configuration time. 



Inverted Test in In makenf snode ( ) , one of the tests that determines whether to reuse a cached 

makenf snode mode or to create a new one was inverted. Under some conditions, this caused 

the kernel heap to grow without bound. 



Adaptec ACB-4000 Controllers If you formatted an st-506 disk controlled by an Adaptec ACB-4000 controller, 

the operation failed with a mode select error. 



File Position Reported The st driver did not report the correct file position if f sf failed when 

Incorrectly skipping files. 



Login Ports 



If /dev/console and /dev/ttya were both enabled as login ports, a panic 
crash occurred. . 



kadb Hung When Booted on The kernel debugger, kadb, hung when booted on a Sun-4/1 10. 

4/110 

asrtf ail System Panic The Sun-2, Sun-3, and Sun-4 kernels were changed to correct the system panel 

and panic: assertion failed: message. Because uprintf also 
caused this message when exiting sysdiag, the kernel now checks for a stream 
pointer before attempting to print to the controlling terminal of a process. 
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Watchdog Reset with Bus Error On 4/1 10 systems running 4.0, bus errors that normally kill applications caused a 

on 4/1 10 watchdog reset instead. The following code, compiled with ‘-g’ and executed on 

a 4/1 10 running 4.0, causes the system to die with a watchdog reset: 




Guards Added to Header Files Guards have been added to the header files in /usr /include, with these 
in /usr /include exceptions: 

/usr/include/ £77 
/usr /include/pas cal 
/usr/ include/pixrect 
/usr/include/ suntool 
/usr/include/ sunview 
/usr/ include/ sunwindow 



Kernel Prints Fault Information The kernel did not always dump meaningful information as it died from a bus 
Carefully, Avoids Watchdog error. To aid developers, showregs ( ) is reworked to correct information 

Reset about a crash. 



Interrupt Loss from 7053 Under On the Sun-3 and Sun-4, spurious interrupts or invalid intermpt vectors hung the 
Heavy I/O Caused System to system and stopped I/O to the 7053 disk. The only recovery was to reboot the 
Hang system. A watchdog mechanism was added to correct this bug. 

Kernel Crashed when Syncloop The kernel driver code was changed so that open routines return an error if the 

Ran on Asynchronous MCP mcp . ops pointer is already set to another protocol. 

Port 

ipc A kernel crash occurred with STREAMS NIT and an IPC board. There may have 

been corruption of stream buffers and control information when STREAMS NIT 
was used. This was observed only on the IPC memory Ethernet driver. The bug 
is fixed. 



^sun 
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On NFS, Vnode Unrecognized The umount system call follows the link and overshoots the mount point, 
as umount Directory The automounter compensates for this by responding as a directory rather than as 

a symbolic link. The vnode type is assigned at moimt time and assumed not to 
change. 

A code change now convinces the kernel that this mount point is a directory. 



kbdriver Kernels configured with some non-Sun keyboard drivers did not work with 

kadb even when a Sun keyboard was used. An I Ll-A I abort that should have 
dropped into kadb instead dropped into the PROM monitor, bypassing kadb. 
This is fixed. 



Igkernel Kernels larger than one megabyte did not work. Kernels worked when built 

smaller than OxfcOOO, while the same sources built on a kernel larger than 
OxfcOOO did not 



Kernel Restarts Instmction that The kernel did not restart the instruction that caused the segmentation violation 

Caused Segmentation Fault (SIGSEGV) when rlimit . rlim_cur was upped after a stack overflow. Now 

the processor state is saved when signals occur so that returning from a signal 
handler causes the processor to continue correctly. 



pObr , pO Ir References The VAX-compatible terms pObr and pO Ir have been replaced in the kernel 

Removed from Kernel with nonVAX-dependent code. This reduces confusion when porting the system. 



/move . s : bcopy ( ) Improperly aligned move . s : beopy ( ) transfers were very slow. Code was 

Transferred Byte by Byte inserted to move data by longwords before the loop to move by bytes, causing a 

3x improvement of longword over byte copying. 



f truncate on /dev/zero 
Changed Major and Minor 
Device Numbers 



Calling f truncate on a file descriptor corresponding to /dev/ zero 
changed the major and minor device numbers so the device eventually became 
unusable, itrunc { ) now verifies the type of inode before begirming an 
operation that might be senseless. 



mb mbugo called xxgo with an invalid md->md_mbinfo. After DVMAranout, 

mbrelse was eventually called to release dvma. This caused a call to mbugo 
to map dvma’s for devices that were waiting while dvma had mn out, some- 
times resulting in mbugo calling xxgo with an invalid md->md_mbinfo. 
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mmpeekio Extra break statements in minpeekio in mem . c prevented the transfer of more 

than one short or long per call to mmpeekio. This has been fixed. 



UDP The kernel variable udpck sum was set for UDP packets and turned on the 

checksum. The checksum did not, however, take effect on NFS, since NFS uses 
its own path through the netwoik code when sending packets. This is fixed with 
a change to the NFS packet-sending module. 



skyr c The kernel panicked on a Sun-2 with a Sky floating-point processor board. 

This bug was fixed earlier, and the new skyrc file is included in this release. 



Lost Files and vm_hat On 128-megabyte Sun-4 systems, the pmem test did not produce one pass in 48 

hours. Also, in some circumstances, an NFS server could lose a write to a file if 
the file was written on a SunOS 4.0 server while being accessed for an NFS read 
request The written data would be part of the file for a while, but the same file 
would have old or spurious data if the data had to be reread from the disk. This 
is fixed by changes to the vm_hat files. 



yppush A 3/260 yp master server crashed with the message panic: bus error, 

every time an attempt was made to push a yellow-pages map. 

An odd set of circumstances in the tcp/ip/ethernet layers of code tickled 
a bug in ether_pullup ( ) . The bug is fixed. 



HZ Exists in The HZ parameter returns ticks per second according to syscalls that return 

<sys/param.h> for Older values in ticks. getrusageO does not return values in ticks. It returns 

System Compatibility struct timeval, parameters that are independent of the clock resolution. 



sizecheck Now Owned by The makefile attempted to change the file-access permissions of sizecheck 
Builder during standalone driver build. The make aborted unless you owned the file. 

All users now have execute permission when size check . sh retrieves from 
sees. 



lint Did Not Work for The makefiles have been changed so you can run lint on standalone drivers. 

Standalone Drivers 
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14.5. SCSI Drivers Bugs The list of bug fixes in SCSI drivers includes 1/4" tape drivers and onboard SCSI 

Fixed and SCSI-3 drivers. 



Length Errors on SCSI Tape Length errors are generated when the blocking factor during a read does not 

match the blocking factor used when recording. These are no longer fatal errors, 
and tape operation can continue. 

physio notices the requested transfer count does not match the actual count and 
issues another I/O request. This takes care of the problem. 



The following command would hang after writing some files to tape because 
biowait on the physio buffer was still marked BUSY. 

find • -print | cpio -ocB >/dev/rst8 

This was a general SCSI problem. The code has been changed, and this bug is 
now fixed. 



This module can return a value of ok, fail, scsi_FAiLor hard_fail. 
When called by sidoneO and sigo() of si. c, the error checking did not 
detect the possible value of scsi_fail; in the interrapt service routine 
siinter,errorchecking did not check scsi_FAiLand hard_fail after 
si_cmd was called. 

In si_cmd, hard_fail is now returned and this fixes the bug. 



The driver would enter arbitration phase without asserting proper ID on the SCSI 
data bus, leaving the contents of the Output Data Register undetermined and with 
a leftover of the previous SCSI transaction. SCSI driver code was changed, and 
this bug is now fixed. 



Missing ^include Statement The following line was missing from / sc_conf . c for Sun-4, preventing a 

build on some machines. 

include sw.h 

Two lines of code were added to fix this bug. 



SCSI Tape End-of-File Flag If end-of-file occurred during a read, the EOF flag did not clear when the driver 

Not Cleared closed. 



No ID on Arbitration of SCSI 
and SCSI-3 Driver 



SCSI-3 Driver Module 
si_cmd() Did Not Catch Bus 
Error 



biowait Hang with 
SCSI y/' Tape 
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SCSI Tape Driver: f s f Errors 


The driver did not report the location of file-space errors. If such an error 
occurred at beginning-of-tape, an auto-format search was sometimes triggered. 




The driver did not report the position of the file when a file-space error occurred. 
If the error was a blank-check error and occurred at beginning-of-tape, an auto- 
density check was sometimes triggered. 


Sysgen Tape Controllers; File 
Positioning 


f sr and bsr file-positioning operations for ioctl functions now work with 
Sysgen tape controllers. 


Tape File Positioning 
Errors in st . c 


End-of-file and end-of-tape error reporting is the same as that of tar and 
dump: errors are not posted, and only a residual count is returned. Such a report 
is not seen as an error by the ioctl file-positioning operations f sr , bsr , 
f sf , and bsr. The file was changed so that EOF/EOT error reports now fiag a 
fafiure of the requested operation. 


Misleading Messages when 
Cartridge Not in Drive 


When the V/' tape drive is accessed and there is no cartridge in the drive, the 
SCSI tape driver now prints a sensible and informative screen message. 


Extra File Marks on SCSI Tape 
after writi . sp 


If, after a tape write, the SCSI tape driver is closed, then opened and closed again 
without writing any data, the driver writes an extra file mark. 


SCSI Error Recovery Generated 
Bus Error in scdone 


A path through SCSI (sc . c) error handling resulted in a bus error panic 
(kernel trap, invalid reference) from the scdone () routine. 
Changes to a critical code section in the sc driver have fixed this bug. 


tapetop Test Would Hang 
with SCSI Tape and SMD Disk 


The tapetop V/' test in sysdiag would hang at startup, showing neither 
pass nor cycle during 48 hours of run-in with an SMD disk. Rebooting produced 
the message Some processes wouldn't die. This was determined to 
be a SCSI driver problem, and is fixed. 


SCSI Driver Refused Send- 
Data’s Odd-Length Transfer 


The sc . c SCSI drive did not handle the odd transfer length condition for the 
case of a send-data command. Research found a coding error specifying 
receive-data instead of send-data in the odd-length routine. The code is changed 
to fix this bug. 
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swO_cmd : Reselect The reselect failure message was inaccurate, and was changed to indi- 

failure on SunOS 4.0 with cate that a lost hardware reselect interrupt was recovered in software. Hardware 
SCSI Patch involved was a SCSI 155-megabyte disk with a 150-megabyte tape on a Sun- 

4/1 10 running bootprom 2.8 on Sundiag 1.0beta2. 



Bus Failure Prevented Recovery A bad Archive embedded SCSI tape controller allowed the SCSI bus to fail, and 

of Disk I/O for Swap disk I/O for swap was not recovered. The bug was found after a screen message. 

Panic: segu_swapin: getpage failed, showed a failed command 
after missing command phase. 



SCSI Failed when Error messages about sdO : , swO:, stO indicated that sddump routine 

Dumping Core and sdt imer failed to reset the bus to clear out all other SCSI I/O before doing 

SCSI I/O; an ILl-AI abort was required to recover. This is fixed. 



14.6. Serial Drivers Bugs Serial driver bugs in the following list are now fixed. 

Fixed 

Redirecting Console A serial driver redirecting the console to a serial device no longer fails with error 

to Serial Device number 25. 

A few lines of kernel code now equate console device with device', this ensures 
that the TIOCCONS call is recognized by aU serial devices, not just pseudotenni- 
nalpty. 



Software Carrier Detect Flag The software Carrier Detect flag was turned off by the MCP driver. This bug is 
Turned Off by MCP now fixed. 



DTR Asserted on Modem Line Data Terminal Ready was asserted while the communications port was not open, 

while Port Is Not Open allowing the modem to answer with no getty waiting on the line. This bug is 

now fixed. 



DTR Dropped Too Soon after The modem did not recognize a less-than-one-second drop of DTR in cases when 
Serial Port Qose the port was reopened immediately. Increasing DTR drop time to at least one 

second fixed this bug. 

Modem Stams Unreadable It was impossible to read the modem status flags from an ALM or ALM-2 port. 
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Flow-Control Problems with Sun-3 users experienced intermittent flow-control problems with printers operat- 

ALM Board ing from an ALM board. (The problems occurred when printing graphics and 

when running the serial port in LLITOUT.) All known ALM flow-control 
problems have now been fixed. 



4.0 Crashed on Reboot If ALM When SunOS 4.0 was configured for the ALM board and the board was not 

Board Was Missing installed, a reboot caused the system to crash on a Sun-2, Sun-3, or Sun-4. 

This has been fixed so that a screen message advises that the board is missing. 



ALM-2 Acted Up when When using application programs such as vi with an ALM-2, the 

Switching Between Raw and mcp async driver was not waiting for data to be properly flushed before 
Cooked Mode changing the mode information for the MCP. 



Multiple ALM-2 Boards Did In a system with multiple ALM-2s, only board 0 worked reliably; units 1, 2, 

Not Work Reliably and 3 locked up, failed to respond, or responded improperly. 

A one-line code change in the driver corrected attempts to reset all interrupts as 
though they were generated on board 0 and fixed this bug. 



UUCP Unworkable at The tty driver input to the read queue did not drain fast enough when input was 

Transmissions Greater Than thick and fast; when the read queue filled, aU input was discarded. The driver 

9600 Baud was rewritten to increase queueing, buffering, and drain efficiency. The bug is 

now fixed. 



Timeout Table Overflow by When characters came too fast, the 4.0 MTI driver queued multiple timeouts and 

MTI Driver overflowed the timeout table. 

The bug was fixed by rewriting the driver to note that one timeout is already 
queued and to avoid queueing additional ones. 



Large writes to the master side of a pseudoterminal (pty) can be read-queued to 
the upstream slave-side pty driver. If that queue is full, the master side blocks 
until it empties, but it sleeps on the wrong event and, if the queue empties again, 
wakeup never occurs. This is usually masked by a write to the slave side where 
echoed data causes wakeups. 

This bug is fixed. 



Intermittent Flow Control The port would eventually hang, and when XON was sent there was no response. 

Problems on ALM with Plotter The flow control machine was not stripping the parity bit. The new general tty 

patch tape corrects this bug. 
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ALM-2 Driver Was The ALM-2 driver appeared to be dereferencing a null pointer. A code change in 

Dereferencing a Null Pointer the driver fixed this bug. 



Ipr Panicked System Using The Ipr command caused the system to panic if the printer was using an 
ALM-2 Parallel Port ALM-2 parallel port 

Rewriting code in the MCP drivers has fixed this bug. 



Serial VO Did Not Work Printing stopped and output was truncated after printing two or three pages. 

Reliably Terminals ignored flow control. Toggling printer off, then on, performed a 

manual restart 

There were intermittent flow-control problems, with an ALM board on a Sun-3 
running 4.0 and earlier, while printing graphics. Another user reported truncated 
terminal output when using a plotter in 4.0. 

A new flow control module has been written and integrated into all the serial 
drivers. The bug is now fixed. 



14.7. Network Bugs Fixed The network bugs were variously found in the network file system, protocols, and 

other areas. 



Security Hole in yppasswd A security hole in yppasswd has been fixed. 

PC-NFS Search Paths The search PATH of a PC-NFS client could, by mistake, include an NFS- 

mounted file that was not a directory. An attempt to read this “directory” 
could crash the server. 

Sun-4 Gateways Himg Sun-4 gateways sometimes hung, requiring a gateway reboot. 



Spurious VME Interrupts Spurious VME interrupts occurred at processor level 5. 



Internet Name Server Crashes Random crashes occurred in the Internet name server /usr/etc/in. named. 



Checksum Not Occurring The udpcksum variable did not cause NFS to perform a checksum. 
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Broadcast Address Not Reset The if conf ig command in /et c/rc . local did not reset the broadcast 

address; it set the netmask only. 



Limited Maximum TCP (Internet Transmission Control Protocol) limited MSS (Maximum Segment 

Segment Size Size) to half the window, degrading performance on networks with large package 

sizes. 



Break-out Routine Called In the routine ether_output , the code called the break-out routine, setting the 

in Error type variable to the protocol family entry from the registration field. 



passwdand yppasswdDid There was confusion with rpc when passwd encrypted the iccm parameter 
Not Reencrypt Correctly of chkey.cand yppasswd decrypted it Code changes have cleared the 

confusion and ensured secure rpc. 



makedbm Returned makedbm : Yikes ! indicated that the source file was inappropriately format- 

inappropriate Message ted when doing a make-netgroup from / var / yp. The message has been 

changed to be more informative. 



ftp Bug When there was an anonymous ftp account, a command to change the working 

directory to "root would overwrite the struct passwd returned by getpwnam at 
the initial login. Code has been changed to copy struct into another variable. 
This closes the hole that allowed root access to the system, and fixes the ftp 
bug. 



nf s Destroyed Files When a file was checked out using query . c, edited, and compiled, and then a 

sees dif f s made in preparation for checking it back in, the SCCS file was 
destroyed. 



Id error -98 with Creating a make_doc with gnuemaci release 18.51 brought an Id error 

make_doc from gnuemacs -98 message when the directory was mounted from a 4.3 BSD system onto a 

Sun-4/1 10 running SunOS 4.0. A code change has fixed this bug. 



NFS-Based open Did Not Occasionally the NFS data cache for a file was not flushed, even when data was 

Generate Network Status incorrect; and a network stat did not necessarily take place after an open. 

Instead, attributes sometimes came out of the local cache. This has been fixed by 
nf s_open forcing an over-the-wire getattr and by using the attributes to 
check caches. 
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Shared Locks Did Not Turn Off A process opening a shared lock on a remote hie could not always read the most 

NFS Caching current contents of the hie, suggesting that NFS caching was not turned olf. 

Code changes have hxed this bug. 



NFS Data Caches Not Sometimes the NFS data cache was not hushed, even though the data was 

Always Rushed incorrect; this generally occurred in vi. One line of code was deleted, disallow- 

ing the invalidation of the cached attributes, and hxing this bug. 



NFSD Swapped Out Under heavy NFS usage, NFS daemons were swapped out and could not be 

killed except by a reboot. Some systems had many nf sd running. New code 
has been written to take care of this bug. 



rpc . lockd Exclusive locks always succeeded for local hies, but a lock request from a 

remote client failed. 

rpc . lockd dumped core after several hours of execution. 

The lock manager under 4.0 sometimes failed with the message. Can' t talk 
to local St atd, causing processes using the lock manager to enter ‘D’ state 
and stay there. Code changes to rpc. lockd have hxed these bugs. 



rpc . mount d The moimt daemon did not allow a host to mount a hlesystem listed in an rw= if 

it was not also listed in access=. 



Bad IP Checksums on In transmission protocols the IP checksiun was calculated by an algorithm that 

Some Packets ’ made it possible to generate several packets in sequence with bad checksiuns; 

this could cause an NFS operation on a soft-mounted hie system to fail. A brief 
code change has hxed this bug. 



Broadcast Requests Looped Ethernet drivers were looping back broadcast requests through the loopback 

Back to Originating Machine driver with a different netmask; this led to a machine incorrectly answering its 

own ICMP_NETMASK broadcast. A change of code has hxed this bug in this 
release. 



Ypserv with Interdomain If ypserv was using the interdomain resolver, the yeUow pages library did a 

Resolver Hangs mount bogus match on an empty string, and ypserv attempted to resolve the empty 

string. 

Yellow pages library code is changed to ensure that ypmatch and ypserv do 
not attempt to operate on an empty string. 
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ypbind 



yppasswd 



rsh and r login Failed Due 
to Order of hosts . equiv 
Entries 



panic : dirremove During 
PC-NFS Writes to NFS- 
Mounted Filesystems 



14.8. Compiler Bugs Fixed 



No Recursive Check for Shared 
Libraries 

Id Error Message 



Id: Library Name and Common 
Name Collided 



Id Option Could Not Be 
Turned Off 



Under server loads greater than 8, yellow-pages operations sometimes failed 
when ypbind was imable to write the binding file in time and, in effect, 
became one of the top users of CPU cycles. 

The code has been reordered to update the file in a more rational way. 



It was discovered that the rpc . yppasswd program could be breached in 
SunOS 3.x or SunOS 4.0 if a program was written where yppas s wd was used 
in place of rpc . yppasswd; this allowed a line entry to be added to the pass- 
word file. 

The code has been changed to fix this bug. 



Remote operations failed when the order of the entries in 
/etc/hosts . equiv did not match the order of entries in /etc/hosts, 
and long host names with dots were not correctly recognized. Code changes 
have fixed this bug. 



Writing to an NFS-mounted filesystem through PC-NFS sometimes caused a 
check in uf s/uf s_dir . c to generate a panic : dirremove condition. 
This apparently occurred when an application on the PC attempted to remove 
files in the remote filesystem. (This should only occur when attempting to 
remove a directory with a nuU, or zero-length, name.) 



Bug fixes associated with the compiler library and linker are listed in the next 
sections. 



The link editor Id did not recursively check for shared library dependencies. 



While linking an executable comprised of two objects (one constructed as a “-r” 
of several objects) and the System V shared C library, the link editor Id returned 
an error message. 



When using Id, if a collision occurred between a library name and a common 
name, aU references were relocated to the library name. This bug has been fixed. 



The Id option, -assert definition, could not be turned off. 

A -noas sert option has been added to Id and the compiler driver updated. 
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Nonspecific Exit Codes in The single exit status returned by Id . so, 127(10), made for gross recoveries 

Id . so Caused Qumsy from temporary failures — ^mail aborted instead of being requeued. The linker 

Recoveries code is changed to return more specific exit codes, conforming to the standards in 

sysexits . h, and this bug is fixed. 



Id . so Operated Incorrectly in If a dynamic binding to a S 5 mabol that was actually a common occurred. Id . so 

Dynamic Binding to a Common would crash or perform the binding incorrectly. Code has been changed that 

resets the object identity in the Id . so lookup cache and records the link map 
entry for main. This bug is fixed. 



Nonstandard Link Command The link command. Id -N -T 0 -ofiknamesJilerumes,cmseA\x)i(h adb 
Generated adb and rm and rm to fail. The command would create a bad symbol table in some cases. 

Failures This bug is fixed. 



Id with -A, -X Options Work around this by omitting the -x option; this produces an executable with a 

Produced Bad Output File readable symbol table. The executable contains the symbol _DYNAMIC, which 

may also be an error. 

Watch Points Not Working The following data watch points did not work properly: stop <var>, stop 

Correctly IF, and when. 

Bit Fields Displayed Incorrectly dbx did not display the bit fields of a C stracture correctly. 

Compile with -Bstatic Id produced an obscure error message when linking an executable comprised of 

Option Failed on 4.0 EXPORT two objects and the SystemV shared C library. It was found that no options were 

passed to Id in Makefile, inter. The lack of certain options implied that 
a shared object was being built These bogus shared objects were included in 
libc . a, producing the error message 

_etext : /lib/libc. a (des_crypt .o) : multiply defined 
This bug is fixed. 

newkey Failed The command, newkey -u root, followed by a password, resulted in the 

under 4.0 EXPORT message Id. so: call to undefined procedure _cbc_crypt 

from 0x20196 when the file cbc_crypt in libc . so was missing. 
Changes were made to Makefiles in /usr/ src/bin, 

/ usr/ scr/usr .bin, /usr/ src/usr . etc/ yp, and 
/usr/scr /Makefile . inter, and recompiled to fix this bug. 
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Older Sxm-2 Object Files Attempting to link archived object files with machine type 0 (m_oix»sun2) pro- 

FailedtoLink duced the message. Id: <file>: wrong machine type. This was fixed 

by expanding the check for M_68010 to allow an m_oldsun 2 object file. 



Dynamically Linked Programs Id . so obtains the stack-size limit when building a heap for itself at the stack 
Require Page- Aligned Stack extreme limit. If the stack-size limit (in bytes) is not page-aligned when passed 

Limit to Execute to the mmap ( ) system call, mmap ( ) fails the mapping request with an error 

message similar to this: Id. so: map heap error (22) for 

/dev/zero. 

Id . so now rounds up the value of the stack-size resource limit to the next 
whole page before using it. 



If the _DYNAMic data stmcture of a program using shared libraries was cor- 
rupted, the program died without any error messages from the run-time loader. 
Id . so now checks the version number in _dynamic of the a . out that 
caUs it 



Id Error Message when This happened when Id option -e (entry point) was placed on the command line 

Linking Two-Object Executable after the name of the file to be processed. Id allocated more space than needed 
and Sys V Shared Library for the string area. This bug is fixed. 



opreg When a C function call returns a structure and includes arguments of type float, 

the argxunents are converted to double; however, SunOS 4.0 and Sys4-3.2 com- 
pilers did not convert them. This is fixed by changes to the /usr/lib/ccom 
file, but requires renaming (and saving) the old lib/ccom to keep it out of 
mischief. 



target target in a. out. hand set jmp. h conflicted with compiler builds; 

Pascal 1.1 could not build on a 4.0 machine. The files have been changed to fix 
this bug. 



Sun-4 /bin/as Dumped Core The Sun-4 assembly/optimizer could dump core if . stabs and . stabn were 

with / .stabs -01 -S present, optimization was enabled (-01), and disassembly was enabled (-S). This 

bug is fixed. 



a . out Died without Error 
Message 
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14.9. Debugger Bugs Fixed Both dbx and dbxtool required changes to fix these problems: 



dbxtool 



dbxtool was putting corrupted filenames in the top window. 



dbx 



dbx was not dealing with object files with multiple N_SO entries, not knowing 
that . for and . vf suffixes imply fortran, nor correctly handling source files 
with the same prefix, such as a. for and .f. 

On Sun-4, a Fortran do loop caused dbx to print spurious values; dbx was 
not correctly displaying variables assigned to SPARC 1 registers. 

next and step could not step over fioating-point branches on a Sun-4 running 4.0; 
step overjp failed. 



dbx did not always apply USE-path when searching for source; as an example of 
the failing, in this program both diagnostics and the failure to set a breakpoint are 
errors: 



mkdir a 
mkdir b 
cd a 

cat > a/c « EOF 
main ( | ) 

{ 

} 

EOF 



» 

» 



cc -g a.c 
mv a.c . . /b 
dbx a. out 
use . . /b 
file a.c 

warning: File 'a.c' has 
stop at 3 

file "../b/a.c” was not 
status 



not been comp [i led with the -g option 
compiled with the -g option 



dbx was unable to read a core file on a Sun-4 with shared libraries; running 
dbx on an executable that dumped core gave this message: warning : 
object file read error: text address not found 

dbx could not deal with object files with multiple n_so entries; it did not know 
that . for and . vf implied Fortran, and never correctly handled multiple 
source files wifli different prefixes. Compiler code change has fixed this bug. 

The dbx step command took longer to execute on a Sun-4 than on a Sun-3. 

This is no longer the case. 
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14.10. Utilities Bugs Fixed System utilities bug fixes are described here. 



syslogd syslogd failed to define loghost name, causing a syslog race condition. 

catman The utility /usr/et c/catman -p failed with an error message. 

Ipr The usage Ipr -r -s could conceivably delete files on a remote host and 

produced an error message such as the following in the printer log file: 

/usr/lib/lpd: imagen: 776 6: open failure <errno = 2> 

graph ( 1 G) When attempting a multiple operation pipe — splinelgraphlplot — on Sun-4, 

graph went into an infiriite loop; graph also gave incorrect answers on Sim-4. 
This is fixed. 



Security Holes There were security holes in sendmail and in the in . f ingerd daemon. 

tar Executing tar with the xcf options (instead of xvf) as in the following 

example erased the floppy. 

tar xcf /dev/rfdOa 

login ( 1 ) A password entry with a negative user ID and no password defaulted to root; 

login has been changed to fix this. 



passwd Created Password Library routines getpwent , getpwnam, getpwuid just skipped over and 

Entry if /etc/passwd did not do anything about blank lines in /etc /passwd. The code has been 

Contained Blank Lines changed so blank lines are no longer mapped to an empty password, and existing 

empty password entries are stripped from the file. 



uuxqt Attempts to execute a command with uuxqt on Sys4-3.2 failed with an XQT 

DENIED message. A ‘bad command’ debugging error message was issued after 
checking the ‘L-cmds’ and USERFILE files. This has been fixed. 



Ipd Dumped Core when Ipd used a fixed-size buffer for barmer lines; when the line was too long, it 

Filename Exceeded 132 dumped core. This is changed to dynamically allocate space for banner lines. 

Characters 
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Ipd Passed -wO Default when The width parameter was set to 0 unless the user specified a different value using 
Ipr Width Unspecified the -w option of Ipr. The default has been changed. 



Chesstool Froze The Chesstool would freeze when it was time for the computer to make a move. 

Segmentation Violation Commands to Start game. Move any piece. Choose "Machine 

Occurred In chesstool White" or "Human White", Choose either "Cancel" or 

"Restart " in any combination caused a segmentation violation. It was found 
that the panel-notify procedures in ches st oo 1 . c were declared with the 
wrong argument list, and an argument was dereferenced in machine_proc. 

The code has been corrected. 



During a build on a Sun-3 (but not on Sim-4), the file /usr /kvm/m68k 
incorrectly pointed Vo false and propagated the evaluation of m68k as false. The 
link was changed from /bin/ false to /bin/true to correct the problem 
in 4.0.1 and higher. 



Printer Log File Error Messages st derr for the line printer daemon filters other than the output filter was 

Not Shown directed to the error file instead of the logfile. This is fixed so all messages from 

filters are placed in the log file and mailed to the user. 



Ipr -s Rejected Files on st at () returned a device number that was entered as negative in the control 

Remote Filesystems file. Ipr did not recognize negative numbers and rejected the file. Code was 

changed to enter the device number in unsigned form, and the bug is fixed. 



Ipd Mailed Remote-Print Error The local printer daemon did not read user and host names, so when an error 
Report to Illegal Address occurred, it sent the error report to ‘ 0 ‘ . Code was changed to have Ipd read the 

user and host names fiom the control file. 



14.11. System There were a number of bugs pertaining to format which have been fixed. A 

Administration Bugs few others of miscellaneous character are also corrected. 

Fixed 

format When format dumped the defect list to a file, the list began with defect number 

0. When printed, however, the list began with defect 1. This has been fixed so 
that defect numbering always starts at 1. 

Disks formatted on Xylogics 450 and 7053 controllers were not compatible. 

format aborted if it tried to spare a mapped sector. The program now ignores 
bad sectors if they ate already mapped. 
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In a spare sector, the extract command missed a defect if it was the only one on 
the track. 

format did not provide a failure message when the label command of the util- 
ity failed. The code of label has been modified to warn the user of a labeling 
failure. 

An SMD disk drive formatted under 4.0 was ruined if subsequently formatted 
under 3.5 or Sys4-3.2. This bug has been fixed with the rewriting of format. 

Defective tracks on the disk drive were not brought to the attention of the for- 
matter. The track-defective bit was not checked when original defect informa- 
tion was read from the disk. In the rewritten format, the bit is checked and, if 
set, an error is returned. This ensures that defective tracks are not used. 

format , when run with a 45 1 controller, did not understand a long last sector 
following the ^ata and, when a defect was found in such a sector, the format 
failed. The rewritten format now understands drives with long as weU as 
short last sectors. 

format displayed misleading and unnecessary warning messages when 
irrelevant data was destroyed in the formatting process. Rewriting format 
has fixed this bug. 



format Corrupted Kernel Map When format did not find an incorrectly selected disk type in format . dat, 

and Dumped Core with it dereferenced a null pointer when setting up the default partition table. 

Incorrect Disk Type Selection format is rewritten and this bug is now fixed. 



format Aborts if Defect Spans format could not properly handle a bad sector when the defect entry spanned 

into Next Also-Mapped-Bad the next sector which was also bad. Program code is changed so the defect entry 

Sector does not span into the next sector. 



Defect List Difficult to Recreate If forced to re-enter a defect list from hardcopy, you could not recreate the list 

with an editor (such as vi) or an optical scanner and then load the list with the 
defect/load command. (The operation failed with bad magic number or 
corrupt defect f ile.) Instead, you were forced to use a more time- 
consuming method (the defect/add command). 

The format program now allows either method. You can load any defect list as 
long as the first line is of the form: 

0x1 <number of defects> 0x123 



Long Hostnames Caused 
Boot to Fail 



If you had a server with a hostname longer than 16 characters, booting diskless 
clients failed. 
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Sundiag Test Could Fail 



The Sundiag ipctext could fail, telling that the time limit for the test had been 
exceeded, because the test-start message was not received. 



Security Holes There were security holes in pas s wd, getpwent , getpwnam, and 

getpwuid. 

Remote shutdown Failed When the console received a root rlogin from a remote machine followed by a 

shutdown -h now command, the system would hang after displaying Sys- 
tem going down ... or the Login : prompt, and did not do a disk sync. 
The halt was aborted when ttyname ( ) returned a nuU; and null was returned 
because shutdown kills rlogin before it executes halt. This bug is fixed 
by having halt use "(no tty)" in the audit record when ttyname ( ) returns 
NULL. 



Shutdown Truncates the The first letter of the shutdown message in /etc /nologin was cut off. This 

/etc/nologin Warning has been fixed. 

Message 



mount Returned Incorrect Line mount obtained the line count from valid entries returned from the 
Number for Illegal Entry in getmntentO routine which ignores commented-out lines. An added routine 

f s t ab now allows mount to return the correct line number in the error message, even 

though one or more lines are commented out. 



rpc . mount d Rejected When rpc . mount d could not map a caller’s address to a machine name, it 

Request for Exporting rejected the request, rpc . mount d is rewritten with a bogus host entry struc- 

Filesystem to everybody hire when the client address cannot be found with regular methods to fix this bug. 



SCSI Defect List not 
Dynamically Allocated by 
format 



format formerly allocated a static amount of memory for SCSI defect lists. 

If defects exceeded 127, a bus error was issued. Rewriting format has fixed 
this bug. 



Bus Error Resulted When When creating a null defect list and doing an add command in the defect menu 

Logical Defect Was Added to by selecting the logical defect option, the first defect caused a segmentation 

NuU Defect List violation. This is fixed with the rewriting of format. 



System Accounting Bug Fixed The system accounting utility, /usr/etc/sa, could not accommodate a user 

ID greater than or equal to 65526. When such an ID was encountered, sa 
would loop indefinitely and, at the same time, another sa would be restarted 
daily by cron. This quickly degraded system performance. This bug is fixed. 
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s c s i . h File not included in The SCSI/ALM patch tape did not include s c s i . h and was not compatible 

4.0 SCSI/ALM Patch Tape with Sun consulting specials. This was not a bug, and the oversight is corrected. 



14.12. SunView Bugs Fixed There were two fixed bugs for SunView. 

sunview Exited Leaving When sunview exited, the screen was left in reverse video and text and 

Video Reversed prompts in normal video. A change in suntools . c now saves planegroup 

colonnaps when starting, restores fiiem when exiting, and checks the 0th red 
entry for CG8; this fixes the screen reverse video bug. 



Shared Libraries Had Incorrect Shared libraries, libsuntool and libsunwindow, acquired different 

Version Number Warnings minor version numbers for Sun-2 and Sun-3; this brought incorrect version 

number warnings when a binary built on a Sun-2 was run on a Sun-3. Code 
changes in the shared library files fixed this bug. 

perfineter The perfmeter occasionally dumped core on startup. This was caused by a 

divide-by-zero bug, and is now fixed. 

14.13. Suninstall Bugs 
Fixed 

Default ip Address Illegal The default ip address given by suninstall, 192.9.200.0, is a broadcast 

address and not a legal host address. 

Root Partition Could be suninstall allowed you to designate the root partition as the free space hog. 

Designated Free Space Hog 

Free Space Hog Not Used Soon If you selected too much software for the size of your /usr partition, sunin- 

Enough stall would wait until the partition was totally full (1 10%) before starting to 

steal from the free space hog. 

syslog . conf Caused Loop The syslog . conf file that suninstall creates for a standalone machine 

caused syslogd to loop by indefinitely logging an error. This file has been 
changed to fix this problem. 

The setup_client Script The setup_client script did not always determine whether yp was running. 

The script now performs a more reliable test. 
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/export/swap Partition Not When installing clients on a server with a /export file system (including a 
Used Properly /export/swap partition), suninstall failed if the combined size of the 

client swapspaces exceeded the size of /export. 

Setting Temiinal Type to ‘other’ On the suninstall form to select terminal type, selecting 4 (other) caused a 
Dumps Core core dump. This happened because the buffer used to parse the termcap file 

was too small. The buffer has been increased to the correct size. 

Screen Forms Changed A number of changes were made to suninstall screen forms: 

□ Partition [a] no longer appears as an option for the Freehog Disk Partition 
in the Disk Form. 

□ The name of the Tape I nf ormat ion field in the Software Form has 
been changed to Media information. 

□ Pressing I CTRL-M in the Software Selection form could dump core. This 
happened if the tape was rewinding or if the table of contents was being read 
from the tape. 
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